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INTRODUCTION 



The source product is comprised of magnetic tape(s) that are disc images of source programs. These source 
programs are provided so users can gain a fuller understanding of the structure and implementation of 
previously released software products. The source programs, stored to this medium, also prove to be suitable 
for archival purposes. 

This manual contains the necessary information for using the RTE Disc Utility to access the source programs 
stored on the supplied magnetic tape(s). The manual also contains the general procedure for creating 
relocatables from the source programs. 

It is assumed that the user of this manual is familiar with the operation of the RTE operating system, RTE 
File Manager program, and the RTE On-Line Disc Utility. 

The magnetic tape(s) include a "HELP" file as the first file on Tape 1. This ASCII file is in FMGR format and 
contains the specific information about the included source programs. 

Some of the source programs contained on the tape(s) may have been written in SPL (System's Programming 
Language). To compile these sources, it will be necessary to obtain the SPL/2100 Compiler and operating 
instructions which are available through Data Systems Contributed Library. 
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SECTION I 

HELP FILE 



The HELP file is the first file found on the magnetic tape. (It's on Tape 1 if the source product is contained on 
more than one tape). The file includes the names of all the source programs, the language in which they are 
written, and their part numbers. 

If the source product is on more than one tape, the file will also show which tape each source program is on. 
However, this listing of programs does not necessarily reflect the actual order of appearance within each tape. 

Access to the HELP file can be gained through the FMGR Store command: 

:ST,MT,LU 

where 

LU = list device 

MT = magnetic tape unit 

It's a good idea to get a hard copy of this file for reference when using Section III of this manual. The HELP file 
printout will have a format similar to the following: 



TAPE #n 








FILENAME 


LANGUAGE 


PART NO 


DATE CODE 


source name 1 


ASMB 


XXXXX-18XXX 


xxxx 


source name 2 


FTN4 


-18XXX 




source name n 


SPL 


-18XXX 


xxxx 



1-1/1-2 



SECTION II 

SOURCE ACCESS 



Access to the source programs is gained through the Disc Utility program, which is available on RTE 
operating systems. This utility must be used on-line and all commands issued must be of type "LU". Refer to 
the RTE Utility Programs Reference Manual (Part No. 92060-90017) for details on using these commands. 

The disc image files created by the Disc Utility containing the sources were designed to occupy a 203-track 
scratch cartridge on your disc. This cartridge size is used so that the files can be copied to any HP disc (7900, 
7905/06/20) with complete compatibility. 



NOTE 

The Disc Utility must be used on-line and as type LU because 
of the physical differences in discs. By using the commands in 
this mode, the sources may be restored from and saved to the 
magnetic tape(s) from any of the HP discs specified above and 
still maintain their complete compatibility. 
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Since the first file of Tape 1 is the HELP file, the first file accessible by the Disc Utility is File 2. A sample 
command sequence using the On-Line Disc Utility to access one such file is shown below (user response is 
underlined): 

:RU,RSTOR,LU >> MT,CR 

where 

LU = list device 

MT = magnetic tape unit 

CR = disc cartridge number (203 tracks required) 

FILE #? 

2 Second file (HELP was File 1) 

FILE ID: 

TAPE #1 RTE-IV SOURCE PACKAGE 

TAPE #: 01 

OK? CYES/NO) 

YES 

VERIFY? <YES/N0> 

YES 

VERIFYING 

There may be more than one of these files on your magnetic tape(s). Therefore, if all of the source programs 
specified in the HELP file do not appear in the first file accessed, they will be found in the next file. By 
repeating the above process (specifying the next file), the remainder of the source programs can be accessed. 
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SECTION III 

SOURCE CONCATENATION 



To create relocatables from source programs written in a single language, use one of the following procedures. 

For RTE-II or RTE-III: 

LG,1 Allocate Load-and-Go area 

MS,*name Move temporary source to Logical Source area 

RU, process or ,2,LU,99 

SA,LG,Xname Save contents of Load-and-Go area 

where 

processor = FTN4, ASMB, or SPL 

(name = Source filename 

LU = List device 

Xname = Relocatable filename 

For RTE-IV: 

: RU, processor, 4 name, LU,% name 

where the parameters are the same as above. 

For a source program written in SPL, refer to the operating instructions for the SPL/2100 Compiler. 

Some source program files are actually concatenation of several programs written in different languages 
combined into one file. To create relocatables from these source program files, follow the procedure given 
below. 

Step 1 

a. Determine what language the source program was written in, either by referring to the listing of the 
HELP file or by using the Editor. 

b. Break the multiple language source program file into separate files each containing statements for only 
one language. Do this by using the Editor to separate the file and to create new temporary files. Some 
Editor commands to use are: 

1. /DFTN4 (delete all statements up to the first FORTRAN statement) 

2. /-9999 (delete all subsequent statements) 

3. /ECitempf ile (create a temporary source file, 6 characters maximum) 
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Step 2 

Run the FTN4, ASMB, or SPL processor on each of the temporary source program files and concatenate the 
separate relocatable modules into one resultant relocatable file. 

For RTE-II or RTE-III: 



LG , 1 Allocate Load-and-Go area 

MS ,4tempf i le Move temporary source to Logical Source area 

RU, processor ,2,LU,99 



(Repeat the MS and RU commands for each temporary source 
file created from a multiple language source program.) 



:SA,LG, Xname 
where 



Save the contents in the Load-and-Go area in a relocatable file 



itempf ile = name of a temporary source file created in step 1 

processor = FTN4, ASMB, or SPL 

LU = List device 

Xname = resultant relocatable filename 



For RTE-IV: 



LG, 1 Allocate Load-and-Go area 

RU, processor, itempfi le ,LU , Xternpf i le 



MR, Xternpf i le 



:SA,LG, Xname 



Move relocatable to Load-and-Go 

(Repeat the RU and MR commands for each temporary source 
file created from a multiple language source program.) 

Save the contents in the Load-and-Go area in a resultant relocatable file 



where 

processor = FNT4 or ASMB 

ttempf i le = name of a temporary source file created in step 1 

Xtempfile = name of a temporary relocatable file 

Xname = resultant relocatable filename 

For a temporary source program written in SPL, refer to the operating instructions for the SPL/2100 Compiler. 
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APPENDIX A 

HELP FILE FOR RTE-IV SOURCE PROGRAMS 



TAPE #1 






FILENAME 




LANGUAGE 


OPERATING 


SYSTEM 




&CSY4 




ASMB 


&4DISP 




ASMB 


&RTIM4 




ASMB 


&ASCM4 




ASMB 


&4RTIO 




ASMB 


&4EXEC 




ASMB 


&$TRN4 




ASMB 


&4SCHD 




ASMB 


&$ALC4 




ASMB 


&40CMD 




ASMB 


&PERR4 




ASMB 


&4CNFG 




ASMB 


&$TB14 




ASMB 


&$TB24 




ASMB 


&$SUB2 




ASMB 


MAPPING ROUTINE 




&4PVMP 




ASMB 


LOADR 






&4LDR 




ASMB 



MULTI-TERMINAL MONITOR 

&4MTM ASMB 



POWERFAIL 
&4DP43 

AUTO RESTART 
&4AUTR 



ASMB 



FTN4 



CONFIGURATION EXTENSION 
&$CNFX ASMB 

BATCH MONITOR PROGRAM 

&D.RTR ASMB 

&FMGR ASMB/SPL 

BATCH MONITOR LIBRARY 

&BMLIB ASMB/SPL 



PART NO. 


DATE CODE 


92067-18014 


2001 


-18015 


1926 


-18016 


1805 


-18017 


1805 


-18018 


2001 


-18019 


1926 


-18020 


1805 


-18021 


1926 


-18022 


1805 


-18023 


1805 


-18024 


1840 


-18025 


1926 


-18026 


1926 


-18027 


1926 


92068-18042 


2013 


92067-18001 


1805 


92067-18002 


2013 


92067-18003 


1926 


92067-18004 


1926 


92067-18005 


1805 


92067-18006 


2001 


92002-18007 


1926 


-18008 


2001 


92002-18006 


2001 



A-l 



SPOOL SYSTEM 
&4GPOL 
&J0B4 
&4DV43 
&EXTD4 
&SPCL4 
&4SMP 
&4SP0T 



SPL/ASMB 

ASMB 

ASMB 

ASMB 

ASMB 

ASMB 

ASMB 



92067-18028 2013 

-18029 1940 

-18030 2013 

-18031 1805 

-18032 1805 

-18078 1940 

-18079 1805 



SYSTEM LIBRARY 
&4SYLB 
&ALRN4 
&RNRQ4 
&LURQ4 
&PRTN4 
&EQLU4 
&DRCT4 
&REI04 
&IFBK4 
&C0RA4 
&C0RB4 
&CVT34 
&KCVT4 
&MESS4 
&PARS4 
&PRSE4 
&TMVL4 
&CNMD4 
&CNM0 4 
&IPRS4 
&.MVW4 
&GTST4 
&.EMAP 
&EMI04 
&MMAP4 
&EMAS4 
&EMST4 
&TRLU4 
&IFTY4 
&LGLU4 
&.IAE4 
&.RAE4 
&.XAE4 
&.TAE4 
&.ZAE4 
&ST0B4 
&IDGT4 
&IXGET 
&IXPUT 
&FTIME 
&XLUEX 
&LUTRU 
SENSES 



ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 
ASMB 



92067-18035 


2013 


-18036 


1805 


-18037 


1805 


-18038 


1805 


-18039 


1805 


-18040 


1805 


-18041 


1805 


-18042 


1926 


-18043 


2013 


-18044 


1805 


-18045 


1805 


-18046 


1805 


-18047 


1805 


-18048 


1840 


-18049 


1840 


-18050 


1805 


-18051 


1913 


-18052 


1805 


-18053 


1805 


-18054 


1805 


-18055 


1805 


-18056 


1805 


-18057 


1805 


-18058 


1805 


-18059 


1805 


-18060 


1805 


-18061 


1805 


-18062 


1805 


-18063 


1805 


-18064 


1826 


-18065 


1805 


-18066 


1805 


-18067 


1805 


-18068 


1901 


-18069 


1901 


-18076 


1805 


-18077 


1805 


-18080 


1840 


-18081 


1840 


-18082 


1840 


-18117 


2013 


-18198 


1913 


-18199 


1913 



A-2 



&LIMEN 
&SEGLD 
&.ERES 



TAPE #2 



ASMB 
ASMB 
ASMB 



-18256 1913 
-18257 1913 
-18258 1913 



FILENAME 



LANGUAGE 



PART NO. DATE CODE 



GENERATOR 
&RT4GN 



ASMB 



92067-18009 1926 



SWITCH PROGRAM 
&4SWTH 



ASMB 



92067-18010 1926 



WHZAT PROGRAM 
&4WHZT 



ASMB 



92067-18007 1926 



LOG TRACK TABLE 
&LGTAT 



ASMB 



92067-18008 1926 



EMA VERIFIER 
&#EMA 



ASMB 



92067-18013 1805 



KEYS UTILITY 
&KEYS 



FTN4 



92060-18052 1707 



KEYS DUMP UTILITY 

&KYDMP FTN4 



92060-18053 1707 



SAVE PROGRAM 
&SAVE 



ASMB/FTN4 92060-18039 1901 



RESTORE PROGRAM 
&RESTR 



ASMB/FTN4 92060-18040 2001 



VERIFY PROGRAM 
&VERFY 



ASMB/FTN4 92060-18041 1704 



COPY PROGRAM 
&COPY 



ASMB/FTN4 92060-18042 1704 



DISC BACK-UP PROGRAM 

&DBKLB ASMB/FTN4 



92060-18043 1901 



A-3 



FLEXI DISC 
&MSAFD 



BACK-UP 



FTN4 



92064-18232 



1740 



READ NAMR 
&RDNAM 



TAPE #3 



PROGRAM 



SPL 



92060-18045 



1926 



FILENAME 


LANGUAGE 


ASSEMBLER 




&4ASMB 


ASMB 


&4ASB0 


ASMB 


&4ASB1 


ASMB 


&4ASB2 


ASMB 


&4ASB3 


ASMB 


&4ASB4 


ASMB 


CROSS REFERENCE 




&4XREF 


ASMB 


EDITOR 




&EDITR 


ASMB 


FORTRAN IV 




&FTN4 


ASMB 


&FFTN4 


ASMB 


&0FTN4 


ASMB 


&1FTN4 


ASMB 


&2FTN4 


ASMB 


&3FTN4 


ASMB 


&4FTN4 


ASMB 


&5FTN4 


ASMB 


FORMATTER LIBRARY 




&FF4.N 


ASMB 


DECIMAL SRTING ARITH 


• 


&ADD 


ASMB 


&A2DE 


ASMB 


&CARY 


ASMB 


&JSCOM 


ASMB 


&DCAR 


ASMB 


&DEA2 


ASMB 


&DIV 


ASMB 


&EDIT 


ASMB 


&D1D2 


ASMB 


&D2D1 


ASMB 


&FILL 


ASMB 



PART NO. 



92067-18011 
-18070 
-18071 
-18072 
-18073 
-18074 



92067-18012 



92002-18010 



24998-18002 



DATE CODE 



2013 
1940 
1940 
1940 
1940 
1940 



1805 



2026 



92060-18092 


2026 


-18093 


1913 


-18094 


2026 


-18095 


2013 


-18096 


2026 


-18097 


1913 


-18098 


2026 


-18101 


1913 



1926 



24306-18004 


2 02 6 


-18005 


2 02 6 


-18006 


2026 


-18007 


2 02 6 


-18008 


2026 


-18009 


2026 


-18010 


2026 


-18011 


2 02 6 


-18012 


2026 


-18013 


2026 


-18014 


2026 



A-4 



&GET 


ASMB 


&MOVE 


ASMB 


&MPY 


ASMB 


&PUT 


ASMB 


&SIGN 


ASMB 


&SUB 


ASMB 


&ZONE 


ASMB 


&S.GET 


ASMB 


RTE/DOS LIBRARY 




&RLIB1 


ASMB 


&RLIB2 


ASMB 


&RLIB3 


ASMB 


COMPILER LIBRARY 




&OPN.C 


ASMB 


&CLO.C 


ASMB 


&RED.C 


ASMB 


&WRT.C 


ASMB 


&SPC .C 


ASMB 


&RWN.C 


ASMB 


&EOF.C 


ASMB 


&GMM.C 


ASMB 


&OLY.C 


ASMB 


&RUN.C 


ASMB 


&END.C 


ASMB 


&PRM.C 


ASMB 


&GMS .C 


ASMB 


&WARC . 


ASMB 


&GES.C 


ASMB 


&GEX.C 


ASMB 


&CRE.C 


ASMB 


&ADS.C 


ASMB 


&C .BS2 


ASMB 


&ID.AD 


ASMB 


&C .TRN 


ASMB 


&C .SAU 


ASMB 


&C .SOR 


ASMB 


&C .BIN 


ASMB 


&C .LST 


ASMB 


&C .SCO 


ASMB 


&C .SCI 


ASMB 


&C .SC2 


ASMB 


&C .BNS 


ASMB 


&C .BSA 


ASMB 


&C .BSO 


ASMB 


&C .BBI 


ASMB 


&C . BLI 


ASMB 


&C .BSO 


ASMB 


&C .BS1 


ASMB 


&SUP.C 


ASMB 


&$CLBR 


ASMB 


&C .BIA 


ASMB 



-18015 


2026 


-18016 


2026 


-18017 


2026 


-18018 


2026 


-18019 


2026 


-18020 


2026 


-18021 


2026 


-18022 


2026 



24998-18001 1926 

-18009 1926 

-18011 1926 



92060-18054 


1926 


-18055 


1913 


-18056 


1926 


-18057 


2013 


-18058 


1901 


-18059 


1901 


-18060 


1901 


-18061 


1901 


-18062 


1901 


-18063 


1913 


-18064 


1901 


-18065 


1901 


-18066 


1901 


-18067 


1901 


-18068 


1901 


-18069 


1901 


-18070 


1901 


-18071 


1901 


-18072 


1901 


-18073 


1901 


-18074 


1901 


-18075 


1901 


-18076 


1901 


-18077 


1901 


-18078 


1901 


-18079 


1901 


-18080 


1901 


-18081 


1901 


-18082 


1901 


-18083 


1901 


-18086 


1901 


-18087 


1901 


-18088 


1901 


-18089 


1901 


-18090 


1901 


-18091 


1901 


-18099 


1913 


-18100 


1901 



A-5 



&C .RP 

&GETBF 

&RETBF 

&TRIM 

&MEMBF 



ASMB 
ASMB 
ASMB 
ASMB 
ASMB 



-18102 1926 

92067-18084 1913 

-18085 1913 

-18086 1913 

-18087 1913 



TAPE #4 






FILENAME 


LANGUAGE 




DRIVER PACKAGE 






&DVM72 


ASMB 




&DSCHD 


ASMB 




&DVR15 


ASMB 




&DVR33 


ASMB 




&DVR10 


ASMB 




&PLOT 


ASMB 




&DVR31 


ASMB 




&DVR12 


ASMB 




&DVR00 


ASMB 




&DVR11 


ASMB 




&DVR37 


ASMB 




&SRQ.P 


ASMB 




&IB4A1 


ASMB 




&IB4A2 


ASMB 




&IB4A3 


ASMB 




&IB4A4 


ASMB 




&1DV10 


ASMB 




&2DV10 


ASMB 




&DVA13 


ASMB 




&CHARS 


ASMB 




&TVERF 


ASMB 




&DVA12 


ASMB 




&DVR05 


ASMB 




&DVA05 


ASMB 




&DVR32 


ASMB 




&LP31 


ASMB 




&DVB12 


ASMB 




&DVR2 3 


ASMB 




&DVA47 


ASMB 



PART NO. 



DATE CODE 



9580- 


-18079 


2026 


9580- 


-18125 


A 


9601- 


-18021 ' 


1901 


12732- 


-18001 


1805 


20808- 


-80001 


C 


20810- 


-80001 


C 


29013- 


-80001 


1710 


29028- 


-80002 


1805 


29029- 


-80001 


1740 


29030- 


-80001 


1710 


59310- 


-18005 


2026 


59310- 


-18007 


1805 


59310- 


-18012 


2026 


59310- 


-18013 


2026 


59310- 


-18014 


2026 


59310- 


-18015 


1940 


72008- 


-80001-4 


A 


72009- 


-80001 


A 


91200- 


-18001 


1648 


91200- 


-18002 


1648 


91200- 


-18004 


1648 


92001- 


-18020 


1826 


92001- 


-18026 


1926 


92001- 


-18035 


2013 


92060- 


-18031 


2013 


92062- 


-18009 


1805 


92062- 


-18010 


2013 


92202- 


-18001 


1913 


92900- 


-18002 


1913 
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